home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ARexxTools / rxlistview14.lha / rxlistview / LISTVIEW.readme < prev   
Encoding:
Text File  |  1996-03-01  |  1.8 KB  |  63 lines
  1.  
  2.     LISTVIEW.proc 1.4 - by Rolf Rotvel
  3.  
  4.     DESCRIPTION:
  5.     A listview procedure for your Arexx scripts.
  6.  
  7.     INSTALLATION
  8.     Include it your Arexx scripts :-) 
  9.  
  10.     USAGE
  11.     num = listview(width, height, titletext)
  12.  
  13.     The stem variable, viewline, must have the following format:
  14.     viewline.0 = number of elements
  15.     viewline.1 = first element
  16.     viewline.2 = second element...
  17.  
  18.     Returns number of selected element or 0 if requester was cancelled.
  19.  
  20.     Have a look at util/rexx/cliped33.lha for an example of how to use the
  21.     listview procedure.
  22.  
  23.     NAVIGATING LISTVIEW
  24.     Use cursor or shift-cursor keys to move up and down. 
  25.     Return selects an item and escape quits without selecting anything.
  26.  
  27.     If anyone has a way of detecting the use of ctrl as a qualifier then
  28.     please tell me. I'd really like to use ctrl-cursorup/down to move to the
  29.     top or bottom of the list.
  30.  
  31.     PROGRAMMING NOTE
  32.     It's fairly easy to make the listview respond to the HELP being pressed.
  33.     Change the main loop like this:
  34.  
  35.     do forever
  36.         oldrow = row ; oldvar = var
  37.         char = readch('listwin', 1)
  38.         select
  39.             when char = csi then do
  40.                 char = readch('listwin', 2)
  41.                 select
  42.                     when char = '?~' then do
  43.                         <help stuff>
  44.                     end
  45.                     ...
  46.     
  47.     CREDITS
  48.     Thanks to Preben Nielsen for SCREENINFO() procedure.
  49.     And to Rick Younie's cy 1.1 for inspiration.
  50.            
  51.     COPYRIGHT
  52.     No copyright. Do whatever you want with this.    
  53.  
  54.     DISCLAIMER
  55.     It's your fault :-) 
  56.  
  57.     AUTHOR
  58.     Please send any comments or suggestions to me. I can be reached at 
  59.     2:238/38.0@fidonet or 39:140/110.0@amiganet. Email: rolf@hoa.ping.dk
  60.  
  61.     HISTORY:
  62.     1.4 - First release
  63.